home *** CD-ROM | disk | FTP | other *** search
/ TeX 1995 July / TeX CD-ROM July 1995 (Disc 1)(Walnut Creek)(1995).ISO / web / noweb / CHANGES < prev    next >
Text File  |  1995-02-24  |  7KB  |  152 lines
  1. CHANGES FOR VERSION 2.7
  2.  
  3. New directory structure, new Makefiles.
  4. Distributing gzipped tar file instead of compressed shell archive.
  5. Added l2h filter to convert latex to HTML.
  6. Added -markup option to tools
  7. contrib/norman now has a numarkup, which is markup for nuweb
  8. Fixed unmarkup to handle nuweb chunks, which don't end in newlines.
  9. The awk versions of filters are even more inferior to the Icon versions, 
  10.           and they are barely tested. I will fix bugs as they are reported.
  11.  
  12. CHANGES FOR VERSION 2.6d (which never left Bellcore)
  13.  
  14. New copyright, intended to make it possible to sell CD-ROMs containing noweb
  15. Revisions to the Noweb Hacker's Guide
  16. Added 'elide' filter to icon directory.
  17. Changed totex to turn a reference to ??? into one to nw@notdef
  18. Commented out references to \code and \edoc in support.nw 
  19.     (too chicken to eliminate them completely)
  20. Changed lib/tohtml not to use the awk 'length' variable --- mawk barfs
  21.     (thanks to Bill Trost for bug report)
  22. Changed tohtml not to plant anchor on < or & because that
  23.      could start an SGML tag (thanks to Bill Trost for bug report)
  24. Awk version of tohtml used && in patterns; some awks couldn't handle it.
  25.     (thanks to Mark Smucker for bug report)
  26. Changed \filename to \nwfilename to avoid conflicts with some latex2e packages
  27. Help for the most frequent problems now in INSTALL.
  28. Fixed a bug that bit noweave -index when there are multiple definitions
  29.      of an identifier; tag of first defn was repeated instead of
  30.          getting all tags (thanks to Michael Norrish for bug report).
  31. noweave -html -x was producing local index stuff, but it shouldn't.
  32. Decided -html shouldn't disable -noindex in noweave script
  33. Improved tohtml so it needn't insert * for an anchor so often.
  34. Changed notangle internally so it doesn't complain 
  35.     if a chunk doesn't end with a newline (possible with nufront)
  36. changed noweave so -index no longer forces a latex wrapper
  37. Changed noidx so it won't use HTML specials in unique ids
  38. Changes tohtml not to quote HTML in chunk names
  39.  
  40.  
  41. CHANGES FOR VERSION 2.6c
  42.  
  43. Added -v option to noweave to show the pipeline.
  44. A preliminary Noweb Hacker's Guide.
  45.  
  46. CHANGES FOR VERSION 2.6b
  47.  
  48. Added -autodefs c
  49.  
  50. Changed installation procedure so that source is no longer distributed
  51. with contributed software --- you now must install noweb, then build
  52. contributed software.
  53.  
  54. Bug fixes:
  55.  
  56.  - Makefile didn't create .../man/man1
  57.  - noweave botched -x option, emitted index info anyway
  58.  - markup complained, incorrectly, about [[<<]] in documentation.
  59.  - noidx died if it tripped over an identifier used only in quoted code
  60.  - tohtml wasn't inserting doc anchor into above_defns, so some xrefs
  61.    that should have read `above' were coming out `below'
  62.  - when one identifier was a prefix of another, as in
  63.    Class and Class::member, finduses duplicated the prefix.
  64.  
  65.  
  66. CHANGES FOR VERSION 2.6a
  67.  
  68. Fix bug in finduses that bit on the HP snake.
  69.  
  70. CHANGES FOR VERSION 2.6
  71.  
  72. For the HTML support
  73.   - Invented lots of new @xref markup to support cross-referencing and
  74.     indexing in a formatter-independent way.
  75.   - Rewrote noidx and totex to push cross-reference and index support into
  76.     the back end.
  77.   - Adapted an HTML back end contributed by Bill Trost
  78. Dave Love provided the bug fixes for latex2e.
  79.  
  80. CHANGES FOR VERSION 2.5:
  81.  
  82. Improved Source Code
  83.  
  84. Several parts of the source code have been rewritten in noweb.  I
  85. especially call your attention to the contents of the shell, lib, and
  86. tex directories.  Reading tex/support.nw will help you tinker with
  87. formatting. 
  88.  
  89.  
  90. Enhanced Latex Support
  91.  
  92. Includes INCOMPATIBLE changes to options accepted by noweave (and
  93. noweave's default behavior).  noweb now supports an index of
  94. identifiers and identifier cross-reference in a language-independent
  95. way.  For more information, see the man page for noweave, especially
  96. the -index option.   The man page for noindex tells how to build
  97. indexes for large, multi-file documents.
  98.  
  99. I have added a `noweb' command that acts much like Preston Briggs's
  100. `nuweb'; it extracts all the source programs and also writes a LaTeX
  101. document with full cross-referencing.  See the man page for details.
  102.  
  103. latex support has been improved by changes to noweave, the noweave
  104. cross-referencer, and the noweb document-style option.  Dave Love and
  105. Jon Krom provided impetus for some of these changes in the best
  106. possible way; they sent code.  Improvements include:
  107.   -- noweave now generates latex headers by default.
  108.   -- Code chunks are broken across pages only when they are more than
  109.      a page long. (Thanks to Dave Love.)
  110.   -- Thanks to Dave Love, cross-referenced definitions that appear on
  111.      the same page are now numbered 7a, 7b, 7c, etc. (optionally 7.1,
  112.      7.2, 7.3, or just plain 7; see the noweave man page).
  113.   -- There is a `noweb' pagestyle, which puts source-file names and
  114.      dates on the header line.  It is the default page style for noweave.
  115.   -- noweave inserts no extra newlines, so the line numbers are the
  116.      same in the .tex and .nw files (Dave Love's suggestion; a major win).
  117.   -- By using noweave -delay, you can put a latex preamble in the
  118.      first documentation chunk, and noweave will delay \filename and
  119.      \begindocs until after the preamble, which becomes a WEB-like
  120.      ``limbo'' area (suggested by Dave Love, Jon Krom, and others).
  121.   -- noweave now has a -filter option that lets you name a
  122.      cross-referencer or prettyprinter on the command line.
  123.      You can try Jon Krom's cross-referencer by using 
  124.     noweave -filter $LIB/noxref.krom
  125.   -- notangle has a -filter option that you can use to implement
  126.      slightly different semantics, such as Knuth's ``...''
  127.      abbreviation convention. 
  128.   -- The awk version of the cross-referencer is now almost as good as
  129.      the Icon version; the sole remaining difference is that the Icon
  130.      version ignores case when sorting; the awk version does not.
  131.   -- Bug fixes in noweave's handling of special characters in chunk names.
  132.   -- Many of the shell and awk scripts are now noweb files.
  133.   -- \chunklist is now \nowebchunks, and it need not appear on a line
  134.      by itself.  \nowebindex provides an index.
  135.   -- The TeX support is now somewhat documented; see tex/support.nw
  136.   -- Support for latex's New Font Selection Scheme (whatever that is),
  137.      thanks again to Dave Love.
  138.   
  139. Finally, Kostas Oikonomou has contributed a simple prettyprinter for
  140. Icon programs, and Conrado Martinez-Parra has contributed a
  141. prettyprinter for Dijkstra's language of guarded commands.  I have
  142. made both suitable for use with noweave -filter.
  143.  
  144.  
  145. Bug Fix
  146.  
  147. The code that was supposed to prevent a chunk from including itself
  148. didn't work at all.  So
  149. <<*>>=
  150. Forever <<*>>
  151. @ made notangle very unhappy.
  152.